package com.fhzn.boss.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.fhzn.boss.entity.Tag;
import com.fhzn.boss.entity.TagType;
import com.fhzn.boss.web.request.DictQuery;

import java.util.List;

/**
 * @author 老顾
 * @apiNote
 * @since 2024/1/22
 */
public interface TagService {

    /**
     * 字典/标签分页列表
     *
     * @param dictQuery 请求
     * @return 字典/标签分页信息
     */
    Page<Tag> dictsWithPage(DictQuery dictQuery);


    /**
     * 字典/标签的查询
     *
     * @param type 类型
     * @param code code
     * @return 标签信息
     */
    Tag dict(String type, String code);

    /**
     * 字典/标签的列表查询
     *
     * @param query 字典/标签请求
     * @return 字典/标签列表信息
     */
    List<Tag> dicts(DictQuery query);

    /**
     * 获取有层级关系的列表。如果parentId不为空，返回该层级下所有节点
     *
     * @param type     类型
     * @param parentId 允许为空
     * @return 字典/标签列表信息
     */
    List<Tag> getWithSubTags(String type, Integer parentId);

    /**
     * 保存或更新字典/标签
     *
     * @param tag 字典/标签
     * @return 1
     */
    Integer saveOrUpdate(Tag tag);

    /**
     * 删除字典/标签
     *
     * @param id id
     */
    void delete(Integer id);

    /**
     * 分类维护
     *
     * @param type 字典/标签类型
     * @return 1
     */
    Integer saveOrUpdateType(TagType type);

    /**
     * 获取字典/标签
     *
     * @param id 字典/标签id
     * @return 字典/标签信息
     */
    Tag getById(Integer id);

    /**
     * 查询字典/标签分类列表
     *
     * @return 字典/标签分类列表
     */
    List<TagType> dictsClassifyList();

    /**
     * 查询字典/标签分类列表
     *
     * @param appCode 应用编码
     * @return 字典/标签分类列表
     */
    List<TagType> dictsClassifyAppCodeList(String appCode);

    /**
     * 查询内置字典/标签分类列表
     *
     * @param appCode 应用编码
     * @return 字典/标签分类列表
     */
    List<TagType> dictsBuiltInAppCodeList(String appCode);

    /**
     * 导入平台字典/标签
     *
     * @param data 字典/标签数据
     */
    void importPlatformDict(String data);
}
